home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr33 / 2col56.zip / 2COL.DOC < prev    next >
Text File  |  1995-03-08  |  48KB  |  1,166 lines
  1.                                  2col
  2.  
  3.                          Shareware Version 5.6
  4.  
  5.                       A Compressed Print Utility
  6.  
  7.                           Copyright 1990-1993
  8.                                   by
  9.  
  10.                           ARCaine Technology
  11.                             960 Neilson St
  12.                            Albany, CA 94706
  13.                             (510) 527-9859
  14.  
  15.                           All Rights Reserved
  16.  
  17.  
  18. CONTENTS
  19.  
  20.   Disclaimer
  21.   Introduction
  22.   Important!
  23.   Hints
  24.   Registration
  25.   Registered Version Features
  26.   Terminology
  27.   Usage
  28.   Description of Options
  29.   Examples
  30.   Using 2col with a Word Processor
  31.   Using 2col with MS Windows
  32.   Landscape Printing with 2col
  33.   Program Abort
  34.   Support
  35.   Distribution
  36.   Email addresses
  37.  
  38.  
  39. DISCLAIMER
  40.  
  41.   This software and manual are sold "as is" and without warranties
  42.   as to performance or merchantability or any other warranties
  43.   whether expressed or implied. Because of the various hardware and
  44.   software environments into which this program may be put, no
  45.   warranty of fitness for a particular purpose is offered. We will
  46.   not be liable for any special, incidental, consequential, indirect
  47.   or similar damages due to loss of data, inability to use this
  48.   program, or any other reason, even if we or our agent have been
  49.   advised of the possibility of such damages.
  50.  
  51.   Be warned that not all data may print correctly when using this
  52.   program with unconverted wordprocessor files.
  53.  
  54.   The user must assume the entire risk of using and evaluating this
  55.   program. Any liability of Tony Caine or ARCaine Technology will be
  56.   limited exclusively to product replacement or refund of purchase
  57.   price. If you find these terms unacceptable, do not use this
  58.   product.
  59.  
  60.   On every matter relating to this program the user consents to the
  61.   exclusive jurisdiction of the state and federal courts residing
  62.   respectively in Alameda and San Francisco Counties in the state of
  63.   California.
  64.  
  65.  
  66. Introduction
  67.  
  68.   2col prints an ASCII text file in two columns,each up to 80
  69.   characters wide, on standard width paper. It eliminates
  70.   consecutive blank lines and prints at 20 characters/inch.
  71.  
  72.   2col will now optionally print from 1 to 6 columns across the page
  73.   using columns up to 160 characters wide. The maximum number of
  74.   characters which will print across the page is usually limited by
  75.   your printer hardware to 160 or 137 in portrait mode. Wide
  76.   carriage printers and landscape mode printing allow more.
  77.  
  78.   2col now supports Deskjet printers as well as dot matrix printers.
  79.   2col can also print in landscape mode directly on Deskjets and
  80.   with the use of a sideways printing program on other printers. See
  81.   section below on landscape printing. See the insructions for using
  82.   the -J option when running on a Deskjet printer. You must always
  83.   use the -J option with a Deskjet. The registered version of JETCOL
  84.   also supports DJs and DJ compatible inkjets with added features
  85.   like variable font pitch and more flexibility in font selection.
  86.  
  87.   Bubblejet and inkjet printers are supported in their Epson LQ
  88.   emulation mode. Treat them like a 24 pin dot matrix printer and
  89.   use -Q.
  90.  
  91.   If you have a laser printer, get the companion program, JETCOL.
  92.  
  93.   2col can now print rough drafts of some wordprocessor formats
  94.   including .WRI, Word, Wordstar, and WP-Generic files. See details
  95.   and, particularly, limitations under the Wordwrap option.
  96.  
  97.   2col is designed to be extremely easy to use. The default settings
  98.   will accommodate most printing needs. On most  9-pin printers
  99.   you can print a document by simply typing: 2COL [filename] <enter>
  100.   For example, to print this manual type:2COL 2COL.DOC <enter>
  101.  
  102.   With 24-pin printers you must also include -Q on the command line.
  103.  
  104.   To see an 8 page demonstration of 2COL's many print modes you can
  105.   type: DEMO2COL [9, 24, or J] <enter>. If your printer cannot print
  106.   20 char/in you should include -W68 on the command line. All IBM
  107.   mode printers are 17 cpi and require -W68.
  108.  
  109.   2col is intended to greatly reduce the huge volume of paper that
  110.   results from printing reference manuals and text files. Regular
  111.   use of this program should cut your paper bill by 60 to 70
  112.   percent. It provides excellent readability (unlike other
  113.   compressed print programs) while compressing an average of
  114.   four pages of source material onto one side of a sheet of
  115.   paper. By using its even/odd alternate side print feature eight
  116.   pages of text can be printed using both sides of a page. Since the
  117.   normal draft mode of printing can be used, it is also much faster
  118.   than those programs which rely on nonstandard print modes.
  119.  
  120.   By reducing the volume of paper, 2col also reduces storage
  121.   requirements and the bulk one has to carry around when traveling.
  122.   It can also save you money when faxing or mailing documents.
  123.  
  124.   As a side benefit, many 2col users actually find it easier and
  125.   faster to read the compressed versions than the originals because
  126.   they can take in more words at one time without having to scan
  127.   across the page.
  128.  
  129.   2col will optionally print in subscript mode - doubling the amount
  130.   of text contained on a single sheet to a total of sixteen pages -
  131.   with a significant loss in legibility and printing speed. This
  132.   mode is intended mainly for archival use not for documents that
  133.   will be read frequently.
  134.  
  135.   This program will work on most Epson-compatible dot-matrix
  136.   printers which provide 17 characters/inch compressed printing but
  137.   is especially intended for newer printers which have a
  138.   compressed/elite mode (20 char/in) allowing two complete 80
  139.   character lines to be printed across the page. Printers which
  140.   support 20 char/inch include:KXP1180, KXP1124, FX86, 200GX,
  141.   LQ-series (except LQ1500), etc. If you have a 17 char/inch printer
  142.   you will probably need to use 2COL in word wrap or reformat mode.
  143.  
  144.   Since most printers do not show the 20 char/inch mode on the front
  145.   panel, you should check the manual or just try printing with 2col.
  146.   If your printer supports 20 char/in but does not operate properly
  147.   with 2col, contact me, and I will let you know if it is possible
  148.   to provide you with an updated version that is compatible with
  149.   your printer.
  150.  
  151.   2COL will now work in a limited way with many other printers. See
  152.   the documentation for the -J-2 command. This is a registered
  153.   feature but you can test it using the -K option.
  154.  
  155.   Use of proportional fonts is now possible. See the -: option.
  156.  
  157.   A macro for using 2COL with David Hamel's BOXER text editor is
  158.   now provided.
  159.  
  160.   Malcolm Drury's VIEW which lets you view and print ASCII, WP, WFW,
  161.   AmiPro and WFD files, now has a 2COL interface. See "Registration"
  162.   section below to obtain a copy.
  163.  
  164.   A MS-Windows menu interface is also available. See PRODUCTS.DOC.
  165.  
  166.  
  167. IMPORTANT!
  168.  
  169.  
  170.   DOT MATRIX:
  171.   The 20 char/in mode on many printers cannot be accessed by
  172.   software if the DIP switches inside the printer are set for IBM
  173.   mode. The printer MUST be set for the Epson/Standard mode. 2col
  174.   will optionally supply the control characters to cause the full
  175.   IBM character set to print. Also, your printer should have the
  176.   auto linefeed switch turned off. If your printer has a front panel
  177.   pitch control, it should be set to program mode. On most printers
  178.   it is okay to set a specific font from the front panel as long as
  179.   the pitch is left in program mode.
  180.  
  181.   Also, be sure that your paper is correctly lined up with your
  182.   printer's top of form according to your printer manual. If your
  183.   paper is misaligned, every page after the first will begin in the
  184.   middle of the sheet when printing with 2COL.
  185.  
  186.   DESKJET:
  187.   If you have previously been printing standard size characters with
  188.   perf skip on, you must push the reset button on your printer
  189.   immediately before printing with 2COL or use the -J1 option.
  190.   Otherwise, the first page will not print correctly. Also, -W68 and
  191.   -W67 may truncate lines on the Deskjet because of its 16.67
  192.   cpi font pitch.
  193.  
  194.  
  195. Hints
  196.  
  197.   Since 24-pin printers tend to print a taller font than 9-pin
  198.   printers, both in subscript mode and standard, it is advisable to
  199.   use fewer lines/page with 24-pin printers to get optimum
  200.   readablity and appearance. The lower the -L value you choose, the
  201.   larger the space between lines.
  202.  
  203.   Since 2COL does not issue any font selection commands, the last
  204.   font selected for your printer will be the one used. Fonts may be
  205.   selected via the printer control panel or by a printer control
  206.   program. At 20 characters/inch the most readable font (and the
  207.   fastest) is usually the standard draft font. Letter quality fonts
  208.   tend to be too "busy" for good compressed printing. Registered
  209.   users can use the -# option to select fonts.
  210.  
  211.   2COL does issue a printer reset when it finishes and if the font
  212.   you selected is not your default font, it may need to be
  213.   reselected before printing again.
  214.  
  215.   You will find it most convenient to use 2COL if you install it in
  216.   a directory which is located in your PATH statement. See your DOS
  217.   manual for more information.
  218.  
  219.   When using a Deskjet you will probably want to use a top margin of
  220.   -F4. Also, try selecting the draft mode on the printer's control
  221.   panel. You may find it adequate for 2COL printing.
  222.  
  223. Registration
  224.  
  225.   This is not freeware or public domain. Shareware is simply a means
  226.   of marketing commercial software. You are required to register if
  227.   you use this program after a 30 day trial period.
  228.  
  229.   I will keep improving the program if I know enough people are
  230.   finding it useful.
  231.  
  232.   My registration policy is very flexible. The nominal fee is $22.95
  233.   US If you don't feel you will get $22.95 worth of use out of 2COL,
  234.   send whatever it is worth to you. All users who register for any
  235.   amount receive 2COL's bonus features described below. Only one
  236.   partial registration per customer please.
  237.  
  238.   Registered users of older versions of 2COL may upgrade for $10.
  239.   Add $5 more if you want the update disk described below. If you
  240.   did not pay at least $20 originally, include an additional $5 to
  241.   upgrade.
  242.  
  243.   When registering, please tell me the version number you have, your
  244.   printer model, and where you obtained your copy of 2col. This is
  245.   particularly important if you pay less than the full registration
  246.   because the registration code you receive will only cover your
  247.   current version.
  248.  
  249.   Foreign checks are OK. See REGISTER.DOC for details.
  250.  
  251.   2col should be registered for the maximum number of computers that
  252.   will run 2COL at your site. Site fees for commercial users can be
  253.   negotiated.
  254.  
  255.   If you register for the full $22.95 fee,and enclose a Shipping and
  256.   Handling fee of $5 I will send you the latest versions of 2COL and
  257.   JETCOL (for lasers). JETCOL requires a separate registration fee
  258.   if you decide to use it after a trial period. I will also send
  259.   other printing related shareware programs including a word wrap
  260.   program (by another author) which can be used to expand or
  261.   contract the column width of documents before printing. This
  262.   program has more options than 2COL's reformatting. This is
  263.   particularly useful for those with 17 char/inch printers which
  264.   cannot print two full 80 character columns. Also included is VIEW,
  265.   which will let you view and print (with 2COL) ASCII, Ami Pro, WP,
  266.   WFW, and WFD files.
  267.  
  268.   Registering for the full $27.95 also gets you a registration code
  269.   which is guaranteed to work on all new versions of 2COL which are
  270.   released over the next 15 months. A lesser registration provides a
  271.   code only good for the most current version.
  272.  
  273.   If you are a Wordperfect user, for an additional $3 I can supply a
  274.   macro which will print your current document with 2COL without
  275.   leaving WP. A similar macro for WFW is also available.
  276.  
  277.   A "professional" version of 2COL is now available for $55 which
  278.   numbers each line and produces an alphabetized index of words in
  279.   the document, and prints footers. If you don't need indexing, you
  280.   can add $10 to the standard version price to just get line
  281.   numbering and footers. Just specify this on your registration
  282.   form.
  283.  
  284.  
  285. Registered version bonus features:
  286.  
  287. * Custom default settings
  288.  
  289.    2COL's default settings can be modified by the user. This
  290.    eliminates the need for the user to enter a string of options
  291.    whenever they run the program. They need only enter the filename.
  292.  
  293.  
  294. * Automargin
  295.  
  296.    The automargin option is extremely useful for those who need to
  297.    punch holes for binding. 2col scans the entire document before
  298.    printing and, in effect, moves all the available "white space"
  299.    from the center (and, if necessary,from the right margin) of the
  300.    document to the left margin. Automargin also automatically
  301.    activates the wordwrap (-&) feature if any line in the document
  302.    is greater than the specified columnwidth (-W).
  303.  
  304.    To get an idea of how Automargin operates, type: 2COL 2COL.DOC
  305.    <enter>. This will print with the default settings of 2col. Then
  306.    type: 2COL 2COL.DOC -K -U8 <enter>. This will print a one page
  307.    demo using automargin.
  308.  
  309.  
  310. * Multiple document names
  311.  
  312.    Multiple document names and wildcards can be entered on the
  313.    command line.
  314.  
  315.  
  316. * Append
  317.  
  318.    When specifying multiple documents to print, registered users
  319.    have the choice of starting each file at the beginning of a page
  320.    or treating all documents as one continuous file without breaks.
  321.  
  322.  
  323. * Redirection of output
  324.  
  325.    Registered users can choose to send the output to a disk file for
  326.    later printing in background (while running other programs) or
  327.    they can send to LPT2, COM1, COM2, etc.
  328.  
  329.  
  330. * Pagefix
  331.  
  332.    Prints a specified number of pages per column retaining original
  333.    line spacing and page breaks.
  334.  
  335.  
  336. * Pagelength adjustment for different paper sizes: A4, legal, etc.
  337.  
  338.  
  339. * Elimination of printer control commands for operation with non-
  340.   standard printers.
  341.  
  342. * User specified printer initialization strings.
  343.  
  344. * Document reformatting
  345.  
  346.   Expand or contract the line width of your document for better
  347.   readablity or more efficient use of page space. Particularly
  348.   useful if you have a 17cpi printer or have trouble reading 20 cpi.
  349.  
  350.  
  351. * The registration screens are eliminated, of course.
  352.  
  353.  
  354.  
  355. Terminology
  356.  
  357.   Since several pages from the original source file are combined
  358.   onto a single page of printer output, there may be some confusion
  359.   about the word "page." We will always refer to the original
  360.   document pages as "source pages." What is actually printed will
  361.   simply be called "pages."
  362.  
  363.  
  364.  
  365. Usage:
  366.  
  367.   2col  [options] path\filename [options] [path\filename]...
  368.  
  369.  
  370.   Options (except -Yx) may be specified in any order before and/or
  371.   after the file name(s). Options MUST be separated from each other
  372.   by spaces and preceded by a "-". Upper and lower case are
  373.   interchangeable.
  374.  
  375.  
  376.  
  377.  
  378.   Options are defined as follows:
  379.  
  380.    -Lxx = Each column will be xx lines long
  381.    -Cxx = No more than xx consecutive blank lines will be printed
  382.    -Sxx = Skip xx pages before starting to print
  383.    -O   = Print only odd # pages
  384.    -E   = Print only even # pages
  385.    -Wxx = column width (number of characters in each column)
  386.    -P   = Pause before printing each page.
  387.    -N   = Prints filename and page # at lower left corner
  388.    -Dxx = Delimit each (source) page with a line and page #
  389.    -T   = Truncate long lines instead of wrap.
  390.    -G   = Enable full IBM character set.(dot matrix only)
  391.    -Fx  = Put a margin of x blank lines at the top of each page.
  392.    -K   = Print a one page demo to test registered options.
  393.  * -Mx  = Set left margin.(CAUTION:READ INSTRUCTIONS BEFORE USING)*
  394.    -?   = 2COL will ask for filenames to print.
  395.    -Q   = 24-pin printer line spacing. Also Inkjet, Bubblejet
  396.    -Jx  = Deskjet mode
  397.    -V   = Report # pages to print.Modify spacing to fill last page
  398.    -&xx = Wordwrap long lines. (useful for .WRI and similar files)
  399.    ?    = (no dash) Displays help screen. Must be the only option.
  400.    -@x  = Print All, Even, or Odd in reversed order.
  401.    -$x  = Number of columns to print (1-6)
  402.    -:   = Output string between columns
  403.  
  404.                 *Bonus features for registered users*
  405.  
  406.    -A   = Append multiple files.
  407.    -Bxx = Force a different font size.
  408.    -Z   = Route output to disk or port.
  409.    -Ux  = Scans file before printing and sets margins automatically.
  410.    -Xx  = Print x pages/column preserving page breaks & format
  411.    -Yx  = Customize 2COL default settings.
  412.    -!xx = Modify line spacing to adjust for pagefill or pagelength.
  413.    -J-2 = Eliminate printer control commands
  414.    -&Rxx= Reformat document to width of xx characters
  415.    -#   = User specified printer init string (fonts,landscape,etc)
  416.    -[xx = Left justify text by xx characters
  417.  
  418.   When more than 102 lines/page requested,shifts to subscript
  419.   (half-height) mode. When columns*width is less than 137 chars,uses
  420.   compressed mode (17 char/in.) When columns*width is greater than
  421.   136 uses compressed/elite (20 char/in.)
  422.  
  423.   Defaults: 80 characters/column;88 lines/page;1 consecutive blank
  424.            line; no pause before printing page; do not number pages;
  425.            wrap (not truncate) long lines;0 blank lines at top of
  426.            page.
  427.  
  428.  
  429. Description of options
  430.  
  431.     ?
  432.  
  433.       2COL ? <enter> or 2COL <enter> will display a help screen.
  434.  
  435.  
  436.    -K
  437.  
  438.       Putting -K on the command line activates any registered bonus
  439.       feature (except multiple files printing) for a one page demo.
  440.  
  441.  
  442.    -Lxxx
  443.  
  444.       Each column will contain xxx lines of data. Line spacing will
  445.       be automatically adjusted to approximately fill the page.
  446.       Characters will be normal (pica) height until more than 102
  447.       lines/column are specified; printer will then shift to
  448.       subscript mode allowing up to 220 lines/column. Default value
  449.       is 88. A lower -L value gives more white space between lines.
  450.  
  451.  
  452.     -Cxx
  453.  
  454.       Pages of text frequently contain many blank lines of data.
  455.       Experience has shown that most of these can be discarded
  456.       without sacrificing readability. This option specifies that
  457.       when there are more than xx consecutive blank lines, the
  458.       excess will be discarded. If you set xx=66, 2col will print
  459.       each page in its original format without discarding any blank
  460.       lines. The default value is 1.
  461.  
  462.  
  463.     -Sxx
  464.  
  465.       This feature is useful if you have a paper jam or decide to
  466.       print part now and part later. Using this option will cause xx
  467.       pages to be skipped before printing begins. For example,
  468.       specifying "-S2" will cause printing to begin with page 3.
  469.       When using the -O or -E option remember to count all pages -
  470.       odd and even.
  471.  
  472.  
  473.     -O
  474.  
  475.       This and the -E option allow you to print on both sides of
  476.       each sheet of paper. By specifying "-O", only the odd numbered
  477.       pages will be printed. When printing is complete,reload the
  478.       first page back into the printer with the blank side facing
  479.       the print head and rerun 2col using the -E option.
  480.  
  481.       Alternatively, 2COL will ask you whether you want to print the
  482.       even pages after it has finished printing the odd. Respond "Y"
  483.       after the paper has been reloaded or type "N" to terminate.
  484.  
  485.     -E
  486.  
  487.       Prints only even numbered pages. When using this option after
  488.       the -O option be sure to shift the paper about 1/2 inch to the
  489.       right before starting to print, to allow space for hole
  490.       punching or other binding requirements.
  491.  
  492.       2COL will ask you if you want to print the odd pages after you
  493.       have printed the even pages.
  494.  
  495.     -Wxx
  496.  
  497.       This option specifies how wide each column will be. Wrapping
  498.       or truncating will begin at this position. Unless the wordwrap
  499.       option (-&xx) is chosen, wrapping will occur in mid-word. It
  500.       also determines the print density. If xx * columns is 136 or
  501.       less, the printer will use compressed mode (137 characters
  502.       across the page). If xx * columns is greater than 136 the
  503.       printer will use compressed/elite (160 characters/line). If
  504.       your printer does not support compressed/elite and you try to
  505.       use it, you will end up with a mess. You should then specify
  506.       xx as 68 and decide whether you want to truncate long lines or
  507.       wrap them. You might want to reformat the document with a
  508.       shareware word wrapping program.I can supply one when you
  509.       register. See the "registration" section of this document for
  510.       details.
  511.  
  512.       Due to printer limitations there is no space between columns
  513.       when a column width of 80 is specified. When a width less than
  514.       80 is requested, one space is inserted between columns.
  515.  
  516.     -P
  517.  
  518.       Program will pause before printing each page. Hit any key to
  519.       print a page. This option is useful if you are feeding single
  520.       sheets to the printer.
  521.  
  522.  
  523.     -Nx
  524.  
  525.       This will cause the filename,page and/or date to be printed in
  526.       the lower left-hand corner of each sheet. To avoid confusion
  527.       when using the -S, -O and -E options the page numbering is not
  528.       reset for each document when multiple documents are specified
  529.       on the command line(registered version only).
  530.  
  531.       If x=blank the filename and page number will print
  532.       If x=1 the page number will print.
  533.       If x=2 the current date will print.
  534.       If x=64 the filename will print.
  535.  
  536.       These x values may be added together to achieve any
  537.       combination of the above. For example if x=67 all three
  538.       options (page number, filename, and date) will print
  539.  
  540.  
  541.     -Dxx
  542.  
  543.       If you need to keep track of each source page, this option
  544.       will print a dashed line with a page number in the middle
  545.       whenever a form feed is encountered or after xx lines of data.
  546.       If no xx value is specified 66 lines/page is assumed. Thus
  547.       -D66 is the same as -D. Experience has shown that this option
  548.       will be rarely used because most documents either number their
  549.       own pages or it is just not important to keep track of
  550.       original page breaks.
  551.  
  552.  
  553.     -T
  554.  
  555.       Normally when lines longer than the specified column width are
  556.       encountered, 2col will wrap the data to the next line. If you
  557.       prefer to truncate or discard excess characters on a line, you
  558.       should invoke this option.
  559.  
  560.  
  561.  
  562.     -G
  563.  
  564.       Sends control codes to enable full IBM graphics set (ASCII
  565.       128-255). The graphics set includes line drawing characters
  566.       and foreign alphabets. This function is not for DeskJet.
  567.  
  568.  
  569.  
  570.  
  571.     -Fx
  572.  
  573.       2col will insert x blank lines at the top of each page before
  574.       printing. The default is 0.
  575.  
  576.  
  577.     -Mx
  578.  
  579.       CAUTION: IMPROPER USE OF THIS OPTION WILL CAUSE YOUR PRINTER
  580.       TO PRINT PAST THE BOTTOM OF THE PAGE.
  581.  
  582.       This command sets the left margin x spaces from the edge of
  583.       the page. Default is 0. Use this option with caution! Most
  584.       standard width printers only have 160 print positions across
  585.       the page. If you insert spaces with a margin command, the
  586.       printer will wrap characters that go past the 160th print
  587.       position to the left side of the page, causing  extra lines
  588.       to be inserted. If you use a left margin of 5, for example,
  589.       you might have to set the column width to -W77 to prevent
  590.       wraparound (this is only necessary if printable characters
  591.       would be pushed past the 160th column- blanks don't matter).
  592.  
  593.       The easiest way to achieve a left margin without having to
  594.       worry about characters wrapping is to use the Automargin
  595.       option (-Ux) described below.
  596.  
  597.       Given the limitations of standard width printers, it is
  598.       suggested that you permanently shift your paper several spaces
  599.       to the left. You can adjust your word processor margin
  600.       settings to compensate, so that normal printing will be
  601.       unaffected.
  602.  
  603.  
  604.  
  605.     -K
  606.  
  607.       Including this option on the command line allows any
  608.       registered option listed below to be used, but only for a
  609.       one page demo. This option allows you to explore the
  610.       options available to registered users.
  611.  
  612.  
  613.     -?
  614.  
  615.       Instructs 2COL to ask for files to print once it is running.
  616.       You can specify files both on the command line and when 2COL
  617.       asks for filenames. Separate the file names with spaces. This
  618.       option is useful when 2COL is run from a menu or a Windows
  619.       icon.
  620.  
  621.  
  622.     -Q
  623.  
  624.       Adjusts line spacing for 24-pin printers. If you have a 24-pin
  625.       printer and do not use this option, pages will print too long.
  626.  
  627.     -Jx
  628.  
  629.       Use this option whenever you are using a Deskjet printer.
  630.  
  631.       If x=0 or blank, 2col will not eject a page before printing.
  632.       You can use this option if you have just printed with 2COL or
  633.       if perf skip was not activated. If you have previously been
  634.       printing with perf skip on, you must either push the reset
  635.       button on the printer before running 2col or use -J1.
  636.  
  637.       See discussion for the "-@" option below for deskjet printing.
  638.  
  639.       The switch point for a wider font is 132 characters across the
  640.       page not 137 because the deskjet uses a 16.67 font pitch
  641.       instead of the standard 17 cpi.
  642.  
  643.       JETCOL also supports DJs and DJ compatible inkjets with more
  644.       flexibility of font selection and variable font pitch. See
  645.       PRODUCTS.DOC.
  646.  
  647.     -V
  648.  
  649.       This option prescans the document and tells you how many pages
  650.       (odd+even) will print. If you are printing only odd or even,
  651.       you must divide by two.
  652.  
  653.       If the last page is only partially filled you will be given
  654.       the option to compress the line spacing to eliminate the
  655.       partial page or increase the spacing to fill it. "C"
  656.       compresses the lines. "E" expands the lines. "N" preserves
  657.       the original spacing.
  658.  
  659.       If you are printing multiple documents without the Append (-A)
  660.       option or using the fiXpage (-X) option, you will not be able
  661.       to modify the line spacing.
  662.  
  663.       You can also enter a percentage value with the -V option. For
  664.       example, entering -V35 will cause final pages which are more
  665.       than 35% filled to be Expanded to fill the page and final
  666.       pages less than 35% filled to be Compressed to eliminate the
  667.       page. You can specify from -V1 to -V99. All prompts are
  668.       bypassed in this mode.
  669.  
  670.       Note: It is impossible to always adjust the spacing to exactly
  671.             fill the page. 2COL will come as close as possible.
  672.  
  673.     -&xx
  674.  
  675.       Wordwrap lines to a maximum of xx characters. When this option
  676.       is off (default) 2COL will wrap in mid word.
  677.  
  678.       This wordwrap feature is intended for printing some word
  679.       processor documents (such as .WRI,and WP Generic) where
  680.       carriage return/ linefeeds occur only at the end of
  681.       paragraphs. The current implementation is not intended to
  682.       reformat a document to increase the length of lines which have
  683.       CR/LFs at the end. When in filter mode (see below), wordwrap
  684.       will also print Wordstar documents.
  685.  
  686.       Some wordprocessor programs imbed non-ASCII graphics and other
  687.       control information in their files. The wordwrap feature
  688.       normally eliminates ASCII characters outside of the range
  689.       32-126. This will greatly reduce but not eliminate "garbage"
  690.       when printing these files. WRI files, for example, have
  691.       graphics at the end and you will almost always see at least a
  692.       few lines of garbage when printing unconverted .WRI files. If
  693.       the -G (graphics) option is invoked on the command line ALL
  694.       FILTERING WILL BE DISABLED and all characters ASCII 1-255 will
  695.       be passed to the printer. Filter mode also deletes any line
  696.       beginning with a period ".". This is for printing Wordstar
  697.       documents.
  698.  
  699.       Automargin will automatically activate wordwrap when it sees
  700.       long lines. Since Wordwrap filters out IBM graphics characters
  701.       unless the -G option is specified, it is not advisable to
  702.       leave it enabled all the time as a command line option. Invoke
  703.       it when you need it or let automargin handle it. You can
  704.       prevent Automargin from activating wordwrap by including -&-
  705.       on the command line.
  706.  
  707.       IMPORTANT: Information which has been encoded in non-ASCII
  708.       graphics format will not print in any readable form and will
  709.       be lost. If an EOF (Control-Z) is embedded in the data,
  710.       printing will stop at this point.Further data past an EOF will
  711.       not print.
  712.  
  713.       Wordwrap is intended mainly as a convenience to provide an
  714.       approximation of word processor documents. If you require
  715.       perfect reproduction of the original document, you MUST first
  716.       convert the document to pure ASCII before printing with 2COL.
  717.  
  718.     -@x
  719.  
  720.       This option causes pages to print in reverse order. -@A causes
  721.       all pages to print in reverse. -@E causes even pages only to
  722.       print in reverse. -@O causes only odd pages to be reversed.
  723.  
  724.       The purpose of this option is to eliminate paper shuffling
  725.       with Deskjets,Inkjets or other printers with cut sheet
  726.       feeders. Each printer model has its own paperfeed
  727.       characteristics and you will need to experiment for the
  728.       correct combination of -O, -E and -@ options that work best
  729.       for you.
  730.  
  731.       When printing one-sided on a Deskjet use "-@A" to have the
  732.       pages come out in normal reading order. For two-sided printing
  733.       with a DJ use options "-e" and "-@o" together on the command
  734.       line. When the even pages have been printed take all the pages
  735.       that come out and put them printed side up back into the
  736.       hopper and press "Y" to print the odd pages. The resulting
  737.       stack will have page one on top when printing is complete.
  738.  
  739.       When you are printing even pages in reverse with a document
  740.       which has an odd number of pages 2COL will eject a blank page
  741.       to compensate for the blank end page. You must include this
  742.       blank sheet when feeding pages back into the printer to
  743.       print the reverse side.
  744.  
  745.       The maximum number of reversed pages for one print job is
  746.       limited to 300 or the maximum free disk space, whichever is
  747.       smaller.
  748.  
  749.     -$x
  750.  
  751.       This option selects the number of columns to print across the
  752.       page. You can specify from 1 to 6. When you select multiple
  753.       columns be sure that the number of columns times the column
  754.       width does not exceed your printer's capability for maximum
  755.       number of characters which can print across one line. When
  756.       calculating, remember that 2COL inserts a blank between
  757.       columns except when a column width of 80 is selected. For
  758.       example, if you choose three column printing -$3, you should
  759.       also specify -W52 when printing 20cpi on standard paper.
  760.  
  761.       This option is useful when printing lists of names or labels.
  762.       It is also useful for landscape mode printing and wide
  763.       carriage printers. Registered users should try combining this
  764.       option with the text width reformatting feature -&Rxx.
  765.  
  766.       When combined with the -Z and -J-2 options 2COL can be used to
  767.       format single column ASCII files into multi-column lists.
  768.  
  769.  
  770.     -:x1,x2,x3,x4....,x29
  771.  
  772.       The -: option causes a string (or single character) to be
  773.       output between columns as a separator. It can also contain
  774.       control charcters to line up columns when using proportional
  775.       fonts. The control character can be a tab (-:9) if you have
  776.       previously set the tabs with the -# option. Or it can be a
  777.       "move to absolute position" command (Epson - 27,36,x1,x2).
  778.       Consult your printer manual for your particular printer's
  779.       command string. This feature will be very useful for Deskjet
  780.       and Inkjet type printers with many proportional fonts.
  781.  
  782.       To use the -: option, just supply the decimal values of the
  783.       ASCII characters separated by commas. See the -# option for
  784.       more info.
  785.  
  786.       The following example is for using proportional spacing with a
  787.       vertical line column separator on an Epson 24-pin printer:
  788.  
  789.        2COL PRODUCTS.DOC -:27,36,237,0,124 -#27,112,1 -Q -K
  790.  
  791.       The above example turns on proportional mode and prints a
  792.       vertical bar (ASCII 124) between columns. -K turns on demo
  793.       mode because the -# option used to turn on proportional mode
  794.       is a registered feature. Registered users should omit the
  795.       -K. The -: option is a standard unregistered feature and may
  796.       itself be used without demo mode. Also remember that you may
  797.       need to change the column width and wordwrap setting to
  798.       reflect the pitch of the font you select.
  799.  
  800.       The following puts a vertical line between non-porportional
  801.       columns:
  802.  
  803.        2COL PRODUCTS.DOC -:27,36,237,0,124  -Q
  804.  
  805.  
  806.       BE CAREFUL when using this command. Printing additional
  807.       characters between columns may force characters at the end of
  808.       the line off the page and cause them to wrap around to the
  809.       beginning of the next line. In this case, use narrower columns
  810.       or command the printhead farther to the left when setting the
  811.       second column start point.
  812.  
  813.       Also remember that the downside of using proportional fonts is
  814.       that tables and charts will no longer line up correctly. Best
  815.       results are obtained with compressed proportional fonts. If a
  816.       standard proportional font is used, it should be 8 points or
  817.       less.
  818.  
  819.  
  820.  
  821.     ***Options below are bonus features in the registered version***
  822.                 (Use the -K option to test these features)
  823.  
  824.  
  825.     -Yx
  826.  
  827.       The -Y option allows you to modify 2COL's default settings.
  828.       This MUST always be the first option on the command line
  829.       whenever you use it.
  830.  
  831.       Typing "2COL -Y1 <enter>" will cause 2COL to display all
  832.       current default settings.
  833.  
  834.       Typing "2COL -Y2 [options....] <enter>" will cause 2COL to
  835.       permanently remember those options by modifying the 2COL.EXE
  836.       program itself. Your personal registration code MUST always be
  837.       one of the options specified whenever you modify the default
  838.       settings. Whenever the -Y2 option is used, any options not
  839.       specified on the command line will be reset to the standard
  840.       defaults. Therefore, even if you change only one of your
  841.       custom options, you must reenter them all at the same time.
  842.       The next time you run 2COL the options you specified will
  843.       automatically be used.
  844.  
  845.       For example, if you want to set the number of lines/page to
  846.       102 and print the page numbers at the bottom, you would type:
  847.       2COL -Y2 -L102 -N registration code# <enter>. The next time
  848.       you type 2COL [filename] <enter> It would be as though you had
  849.       typed: 2COL -L102 -N [filename].
  850.  
  851.       If there are several different option profiles you wish to
  852.       use, you can create different copies of 2COL.EXE with
  853.       different names, such as 2COL1.EXE, 2COL2.EXE, etc. The -Y2
  854.       option only modifies the EXE file having the same name and
  855.       path that you type on the command line.
  856.  
  857.       All defaults with an 'x' value can be temporarily overridden
  858.       with a different value on the commmand line. Use an 'x' value
  859.       of 0 to temporarily deactivate Automargin or Pagefix. Any
  860.       option without an 'x' value can be activated by simply putting
  861.       it on the command line. To temporarily deactivate an option
  862.       set as a permanent default, type a minus after the option. For
  863.       example, to temporarily deactivate the N option, you would put
  864.       -N- on the command line: 2COL -N- [filename]
  865.  
  866.       There is also a -Y4 function which works like -Y2 except that
  867.       it only affects options actually specified on the command line
  868.       without resetting all others to the standard defaults.
  869.  
  870.  
  871.       THIS FUNCTION WILL NOT WORK ON .EXE FILES THAT HAVE BEEN
  872.       COMPRESSED WITH PKLITE. You must first decompress, use the -Y2
  873.       option and then recompress.
  874.  
  875.  
  876.     -A
  877.  
  878.       When multiple files are specified on the command line
  879.       (registered version only) you have the option of either
  880.       starting a new page for each file (default) or appending them
  881.       as though they were one continuous file. The -A option causes
  882.       them to be appended.
  883.  
  884.  
  885.     -Bxx
  886.  
  887.       Normally the switch point for font size change is 102
  888.       lines/page. The -B option lets you specify a different value.
  889.  
  890.  
  891.     -Ux
  892.  
  893.       The aUtomargin function allows you to obtain as much margin as
  894.       possible according to the width of the document. 2col scans
  895.       the entire document before printing and adjusts the column
  896.       width to gain as much space on the print line as possible.
  897.       The space obtained is allocated to the left margin until the x
  898.       value you entered is reached. The remaining space, if any, is
  899.       then added to the right margin. If your document has a maximum
  900.       line width of 80 or greater, 2COL will be unable to give you
  901.       any margin at all because of printer limitations.
  902.  
  903.       If you have specified the -E option (to print on the reverse
  904.       side of the page), the first available space is used to create
  905.       a right margin (for binding) rather than a left margin.
  906.  
  907.       Automargin automatically turns on the wordwrap feature (-&)
  908.       whenver lines longer than the columnwidth (-W) are encountered
  909.       in a document and the truncate (-T) option is off. If you do
  910.       NOT want wordwrap activated automatically include -&- on the
  911.       command line. This is safer than truncating lines.
  912.  
  913.       If wordwrap (-&xx) or reformat (-&Rxx) has been specified on
  914.       the command line (or as a default setting) automargin will
  915.       assume a document width equal to the wordwrap value if xx
  916.       is less than the actual document width and will always assume
  917.       a document width equal to the reformat xx value regardless of
  918.       the actual document width.
  919.  
  920.       Automargin also activates the left justify -[ option when
  921.       possible.
  922.  
  923.     -Zfilename
  924.  
  925.       Allows output to be routed to a file instead of to the
  926.       printer. The file can then be printed in background while
  927.       running other programs. For example, to send output to a file
  928.       called PRINT.TXT, you should include -ZPRINT.TXT on the
  929.       command line.If PRINT.TXT does not exist, it will be created.
  930.       If PRINT.TXT already exists, 2col output will be appended to
  931.       the end of the file. This command is only active in the
  932.       registered version of 2col. This option can also be used to
  933.       redirect output to LPT2, COM1, COM2, etc. The default is PRN
  934.       which is usually LPT1.
  935.  
  936.  
  937.     -Xx
  938.  
  939.       Prints exactly x pages in each column preserving original page
  940.       breaks and not suppressing consecutive blank lines. Thus the
  941.       original page formatting is maintained. Allowed range of x
  942.       is 1-3. A page length of 66 is assumed unless modified with
  943.       the -D option.
  944.                        -X option page formats:
  945.  
  946.              x=1                x=2             x=3
  947.  
  948.            111 222            111 333         111 444
  949.            111 222            111 333         111 444
  950.            111 222            111 333
  951.            111 222                            222 555
  952.            111 222                            222 555
  953.            111 222            222 444
  954.            111 222            222 444         333 666
  955.            111 222            222 444         333 666
  956.  
  957.  
  958.     -&Rxx[,tt]
  959.  
  960.       Reformats document to a width of xx and eliminates leading
  961.       blanks. It attempts (but is not always successful) to identify
  962.       tables and headers and avoids reformatting them.
  963.  
  964.       This feature is useful if you have a document which is
  965.       relatively narrow and would like to make more efficient use of
  966.       page space. It can also be used to narrow the columns to allow
  967.       room for a larger left margin. It is also useful if you have a
  968.       document which is too wide to print with a 17cpi printer and
  969.       you wish to reduce it to a width of 68 or less.
  970.  
  971.       A default trigger point of 57 characters is used to determine
  972.       whether a line should be wrapped or left alone. You can modify
  973.       the trigger point to any value you wish by entering the
  974.       optional tt value.
  975.  
  976.       For example, if you want to reformat a document to a width of
  977.       78 characters and use the default trigger you would use -&R78
  978.       on the comand line.If you additionally want to set the trigger
  979.       to wrap lines of width 50 or greater use -&R78,50 on the
  980.       command line.
  981.  
  982.       Unregistered users may test the reformat feature with the -K
  983.       one page demo option.
  984.  
  985.  
  986.  
  987.     -!xx
  988.  
  989.       Modifies line spacing so you can fill non-standard size paper.
  990.       This would include legal or European paper. This option also
  991.       allows you to finetune the pagefill amount of standard paper.
  992.       Entering a positive value expands the spacing between lines. A
  993.       negative value decreases spacing between lines. Although it
  994.       depends on the printer, you should find that values in the
  995.       25-500 range will usually do the job. This option does not
  996.       affect the printer's forms length adjustment. If you change
  997.       paper you must modify the forms length setting before running
  998.       2COL.
  999.  
  1000.  
  1001.     -J-2
  1002.  
  1003.      Eliminates printer control commands. If you have a printer
  1004.      which has a non-standard command set, you can create your own
  1005.      command string to set up your printer,  put it into a batch
  1006.      file and run it before running 2COL. 2COL will not send out any
  1007.      commands which could interfere with your manual setup. 2COL can
  1008.      be made to work with many printers this way, including Diablo
  1009.      630, most IBM's, etc. 2COL's margin setting commands will not
  1010.      work in this mode. You would need to preset the margin as part
  1011.      of your setup string. Unregistered users can test this mode
  1012.      by using the demo (-K) option.
  1013.  
  1014.      You can also use this option to send output to a file for
  1015.      printing with sideways (landscape) print programs.
  1016.  
  1017.      By combining the -J-2 command with -Z , -$1, and -&R, you can
  1018.      reformat a file without printing it.
  1019.  
  1020.  
  1021.     -#x1,x2,x3,x4....,x29
  1022.  
  1023.      Allows user to specify a string of up to 29 bytes to be sent to
  1024.      the printer before 2COL has sends its commands. This allows the
  1025.      user to select draft/LQ printing, a specific font, etc. If the
  1026.      -J-2 command above has been invoked, only the user's -#
  1027.      specified characters will go to the printer and none generated
  1028.      by 2COL. See section below for landscape printing info.
  1029.  
  1030.      The data is specified as decimal numbers separated by commas.
  1031.      For example, if your ribbon is getting weak and you want to
  1032.      use emphasized printing with ESC E you would specify -#27,69 on
  1033.      the command line. You must not include any spaces within this
  1034.      command!
  1035.  
  1036.      Unpredictable results will occur if you specify commands that
  1037.      conflict with 2COL's. Also 2COL does normally send a margin set
  1038.      command at the beginning of every page and the user will be
  1039.      unable to specify a margin with this option except when using
  1040.      -J-2.
  1041.  
  1042.  
  1043.    -[xx
  1044.  
  1045.     Left justify text by xx characters. Up to xx blanks will be
  1046.     removed from the beginning of each line. This will help you to
  1047.     create a margin or print some documents at a more readable
  1048.     character pitch. This feature is automatically activated when
  1049.     using automargin.
  1050.  
  1051.     Since no printing characters are removed, if a large enough xx
  1052.     value is specified all lines of data will be shifted to the left
  1053.     edge of the page.
  1054.  
  1055.     This feature does not operate with the -& or -&R option.
  1056.  
  1057.  
  1058. Examples:
  1059.  
  1060. 2COL 2COL.DOC -L102 <enter>  will print 102 lines/column
  1061.  
  1062. 2COL 2COL.DOC -L102 -N will print 102 lines/column and number pages.
  1063.  
  1064. 2COL 2COL.DOC -G -N  will number pages and enable IBM graphics set.
  1065.  
  1066.  
  1067.  
  1068.  
  1069. Using 2COL with a word processor
  1070.  
  1071.     The wordwrap feature (-&) provides a convenient, but not always
  1072.     perfect,way of printing many wordprocessor files(such as .WRI)
  1073.     In those cases where you cannot get a satisfactory printout
  1074.     directly from a document in its original form, most word
  1075.     processors have what is called an ASCII output or DOS output
  1076.     mode which 2COL will work with. If you are given a choice, it is
  1077.     usually best to convert without line breaks and use 2COL's
  1078.     wordwrap feature.
  1079.  
  1080.     I can supply WP and WFW macros which will allow you to print
  1081.     with 2COL, without leaving WP or WFW. You can print the document
  1082.     you are editing, with a single keystroke. See the registration
  1083.     section.
  1084.  
  1085.     I also supply to registered users conversion programs which may
  1086.     help you print other word processor formats with 2COL.
  1087.  
  1088.  
  1089. Using 2COL with Microsoft Windows
  1090.  
  1091.  
  1092.     A Windows interface is now available which allows selecting
  1093.     files from a menu and editing/excerpting text as well as
  1094.     printing from the clipboard. Files to be printed can be dragged
  1095.     and dropped from File Manager. It also allows printing in
  1096.     background with 2COL. A large selection of custom printing
  1097.     option profiles can be maintained. See PRODUCTS.DOC for details.
  1098.  
  1099. Landscape printing with 2COL
  1100.  
  1101.     2COL will do landscape printing on printers which have a
  1102.     landscape mode. Suggested settings for the Deskjet are:
  1103.  
  1104.     2COL path\filename -#27,38,108,49,79 -!-120 -L75 -W100 -J1
  1105.  
  1106.     also try:
  1107.  
  1108.     2COL path\filename -#27,38,108,49,79 -!-120 -L105 -W100 -J1
  1109.  
  1110.     Some of these options are for registered users, but you can
  1111.     test them by adding -K to the command line.
  1112.  
  1113.     Printers which do not have a landscape mode can print in
  1114.     landscape with 2COL by sending output to a file and then
  1115.     printing with a sideways printing program. Use the -J-2 option
  1116.     to eliminate printer control characters from the output file. I
  1117.     will supply a shareware sideways printing program on your
  1118.     registration disk if you request it.
  1119.  
  1120.     If you develop landscape settings for your own model printer,
  1121.     please pass them along to me. Thanks.
  1122.  
  1123.  
  1124. Program Abort
  1125.  
  1126.     Hitting Control-C (or Control-Break) will terminate the program
  1127.     immediately. The printer will not stop printing, however, until
  1128.     its buffer is empty.
  1129.  
  1130.  
  1131. Support
  1132.  
  1133.     I will be glad to answer questions for registered and to a more
  1134.     limited extent for unregistered users. SUPPORT IS ONLY BY
  1135.     TELEPHONE (except for foreign users.) Non-foreign users should
  1136.     send letters only after a telephone discussion indicates that
  1137.     hard copy is needed. It is much faster to work out problems over
  1138.     the phone. Call 510-527-9859 from 9am to 8pm Pacific Time.
  1139.  
  1140.  
  1141. Distribution
  1142.  
  1143.     Permission is hereby given to copy and distribute this program
  1144.     as long as no more than $10 is charged. It must be made clear to
  1145.     the buyer that this is only a handling charge and not a
  1146.     registration fee. You must include all files in their original
  1147.     unmodified form when distributing this program. Catalog, rack
  1148.     and CD-ROM vendors must either read VENDOR.DOC for additional
  1149.     details or contact the author before distributing 2COL.
  1150.  
  1151.     Permission to distribute may be revoked by the author at any
  1152.     time for any reason.
  1153.  
  1154.     YOU MUST NOT DISTRIBUTE ANY COPY WHICH HAS BEEN BRANDED WITH
  1155.     A REGISTRATION CODE. A program can be unbranded by typing
  1156.     2COL -Y2 <enter>.
  1157.  
  1158.  
  1159. All trademarks used in this document are the property of their
  1160. owners.
  1161.  
  1162.                                                      -Tony Caine-
  1163.  
  1164. Internet:   72614.1451@compuserve.com
  1165. Compuserve: 72614,1451
  1166.